home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / getmenow.zip / CUTPASTE.MAN < prev    next >
Text File  |  1992-02-17  |  9KB  |  259 lines
  1.  
  2.  
  3.  
  4.  
  5.                ┌───────────────────────────────────────────────────────┐
  6.                │                                                       │
  7.                │                                                       │
  8.                │                                                       │
  9.                │                                                       │
  10.                │                 U S E R S  G U I D E                  │
  11.                │                                                       │
  12.                │                                                       │
  13.                │            CUTPASTE command   version 1.00            │
  14.                │                                                       │
  15.                │                                                       │
  16.                │                   February 16, 1992                   │
  17.                │                                                       │
  18.                │                                                       │
  19.                │                                                       │
  20.                │                                                       │
  21.                │                                                       │
  22.                └───────────────────────────────────────────────────────┘
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54. WHAT IS "CUTPASTE"?
  55.  
  56.      CUTPASTE is a utility for reformatting text lines.  That is,
  57. it retains the desired portions of a text line and removes the
  58. excess.  It will also allow text to be rearranged as needed and
  59. paste in additional text specified in the command line.
  60.  
  61.  
  62. WHY "CUTPASTE"?
  63.  
  64.      CUTPASTE (and like utilities) is intended for use with
  65. databases, where record lengths are usually fixed and specific
  66. information is in the same position in every record.  It is a
  67. simple and efficient way to format information for reports or
  68. screen display.  As will be demonstrated, it has other uses as
  69. well (see "rmlist.doc" included with this package).
  70.  
  71.  
  72. IF THERE ARE "LIKE" UTILITIES, WHY "CUTPASTE"?
  73.  
  74.      CUTPASTE is shareware.  Most "like" utilities are not. 
  75. CUTPASTE came about as the result of my having devised a method
  76. for deleting large numbers of files from my hard disk with
  77. minimum effort.  I could not share this method with others
  78. because it involved the use of a licensed cut and paste utility
  79. from one of the "big guys".  CUTPASTE is also only 1/4 the size
  80. of the "big guy" utility I WAS using.
  81.  
  82.  
  83. CAN I USE "CUTPASTE" WITH MY DATABASE?
  84.  
  85.      CUTPASTE can be used with your database if the records are
  86. stored in DOS TEXT format.  If the records are not stored in DOS
  87. TEXT format, results of running the CUTPASTE command on your
  88. files will be unpredictable and probably not what was intended.
  89.      If you are not sure of your file format, experimentation is
  90. a quick, safe way to find out.  CUTPASTE will not alter the
  91. original file in any way.
  92.      If your data is not in DOS TEXT format, your database may
  93. have a built in text conversion facility such as accompanies most
  94. better word processing and spreadsheet software.  Check your
  95. manual for information and instructions regarding conversion to
  96. DOS TEXT format.
  97.      Future versions of CUTPASTE may support specific database
  98. record formats if user feedback indicates that this is desirable.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106. WHAT WILL "CUTPASTE" DO?
  107.  
  108.      CUTPASTE will read a DOS TEXT file and format each line to
  109. the parameters specified in the calling command line.  It will
  110. retain text from the positions in the line indicated by byte
  111. (character) position numbers or ranges.  It will ignore all other
  112. original text for the output record.
  113.      CUTPASTE will paste into each record, quoted text from the
  114. command line that has been flagged with a "-f" switch.
  115.      Multiple iterations of flagged text, individual byte
  116. positions or ranges are allowed in any order.  Multiple
  117. iterations of the same byte positions or ranges are allowed.
  118.      Maximum command line length is 254 bytes.  This length is
  119. the normal limit of the MS-DOS operating system.  Maximum input
  120. record length is 512 bytes.  Results of reading longer records
  121. are unpredictable.  Maximum output record length is 1024 bytes. 
  122. Records will be truncated if command line options result in a
  123. record length that exceeds this number.
  124.      If an output filename is not specified in the command line,
  125. CUTPASTE will output to the screen (this is a good way to test
  126. your command line).
  127.  
  128.  
  129. WHAT WON'T "CUTPASTE" DO?
  130.  
  131.      CUTPASTE will not alter the original data file in any way. 
  132. CUTPASTE will not allow the same file name for input and output. 
  133. CUTPASTE is case sensitive and will not accept option switches in
  134. the wrong case.  CUTPASTE will not process special record formats
  135. in a predictable manner.
  136.  
  137.  
  138. COMMAND LINE SYNTAX
  139.  
  140. cutpaste inputfilename [outputfilename] [col#] [col#-col#]        
  141. [-f"text"]
  142.  
  143. cutpaste            command name
  144.  
  145. inputfilename       the name of the file containing records to be
  146.                     read
  147.  
  148. outputfilename      the name of the file where the output records
  149.                     to be written (optional)
  150.  
  151. col#                a single byte to be output to the new record
  152.  
  153. col#-col#           a continuous range of bytes to be output to
  154.                     the new record
  155.  
  156. -f                  switch indicating that the following quoted  
  157.                     text is to be pasted into the new record
  158.  
  159. EXAMPLE COMMAND LINE
  160.  
  161. The input record:
  162.  
  163. The quick brown fox jumped over the lazy dog.
  164.  
  165. The command line:
  166.  
  167. cutpaste infile.txt outfile.txt 1-4 -f"red" 16-32 -f"a sleeping"
  168. 41-45
  169.  
  170. The output record:
  171.  
  172. The red fox jumped over a sleeping dog.
  173.  
  174.  
  175. EXPLANATION OF THE COMMAND LINE
  176.  
  177.      The input record would be read from the file "infile.txt". 
  178. The output record would be written to the file "outfile.txt"  If
  179. the output file name had been omitted, the output record would be
  180. written to the screen.  1-4 specifies that bytes (characters) 1,
  181. 2, 3, and 4 ("The ") are to be written to the output record.  
  182. -f"red" indicates that the word "red" is to be pasted into the
  183. output record after the first 4 bytes.  16-32 specifies that the
  184. phrase " fox jumped over " (note the leading and trailing
  185. spaces), be written to the output record after the word "red".
  186. -f"a sleeping" instructs CUTPASTE to paste in the phrase "a
  187. sleeping" after "over ".  41-45 specifies that " dog." from the
  188. input record be written to the output record.
  189.      1-4 could have been specified multiple times producing "The
  190. The The The The" which doesn't make much sense but, illustrates
  191. that a range specification may be used more than once.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212. BEGGING FOR BUCKS
  213.  
  214.      So, now we get down to the "nitty-gritty".  Since you
  215. probably got this from a BBS somewhere, there's no point in my
  216. going into a long explanation of the shareware concept.  You are
  217. aware of it.  Let me just say that if you use CUTPASTE and like
  218. what it does, you should pay for it.  A $15 contribution will
  219. bring you the latest version of CUTPASTE, with any new features
  220. (there will be some) and bug (ugh!) fixes that have been
  221. implemented, the addition of your name to my CONFIDENTIAL mailing
  222. list (oh boy!) and my undying gratitude.  Include the desired
  223. disk format for your upgrade (5 1/4" - 360k / 1.2 meg , 3 1/2" -
  224. 720k / 1.44 meg).
  225.      You are encouraged to upload this package to other BBS and
  226. share it with your friends and co-workers.  I ask only that you
  227. distribute the package in its entirety.  Files in the package
  228. include:
  229.                cutpaste.man - this users guide
  230.                cutpaste.exe - the cut and paste utility
  231.                rmlist.doc   - explanation of rmlist.bat
  232.                rmlist.bat   - selective multi-file deletion batch
  233.                               file
  234.                commands.lst - command script for MS-DOS edlin
  235.                               line editor
  236.                order.frm    - painless instrument for obtaining   
  237.                               your upgrade
  238.  
  239.      Correspondence regarding problems with CUTPASTE (heaven
  240. forbid), comments, and suggestions is also most welcome.  Thanks
  241. for your support.
  242.  
  243.                          Bill Leckband
  244.                          1628 S. Everett Place
  245.                          Kennewick, Wa. 99336
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257. "DOS" refers to MS-DOS
  258. MS-DOS is a registered trademark of MICROSOFT CORP.
  259. edlin is a copyrighted product of MICROSOFT CORP.